WPS 基础接口 > 演示 API 参考 > ShapeRange > ShapeRange 对象
代表一个形状范围,即某个文档中的一组形状。形状范围可以只包含文档中的一个形状,也可以包含该文档中的所有形状。

说明

您可以使用任何所需的形状(从文档的所有形状中进行选择,或从选定内容的所有形状中进行选择)构造形状范围。例如,可以构造一个 ShapeRange 集合,其中包含文档中的前三个形状、文档中所有选定的形状,或文档中所有的任意多边形。

有关如何使用一个形状或同时使用多个形状的概述,请参阅 使用形状(图形对象)。

以下示例说明如何执行下列操作:

示例

使用 Shapes.Range(index) 返回代表文档中的一组形状的 ShapeRange 集合,其中 index 是形状的名称或索引号,或由形状的名称或索引号组成的数组。可以使用 Array 函数构造名称或索引号的数组。以下示例设置 myDocument 上第一个和第三个形状的填充图案。

示例代码
let myDocument = ActivePresentation.Slides.Item(1)
myDocument.Shapes.Range([1, 3]).Fill.Patterned(msoPatternHorizontalBrick)

以下示例设置 myDocument 上名为“Oval 4”和“Rectangle 5”的形状的填充图案。

示例代码
let myDocument = ActivePresentation.Slides.Item(1)
let myRange = myDocument.Shapes.Range(["Oval 4", "Rectangle 5"])
myRange.Fill.Patterned(msoPatternHorizontalBrick)

虽然可以使用 Range 方法返回任意数目的形状或幻灯片,但如果只需要返回该集合的一个成员,则使用 Item 方法会更为简单。例如,Shapes(1)Shapes.Range(1) 简单。

使用 Selection 对象的 ShapeRange 属性返回选定范围中的所有形状。以下示例设置第一个窗口的选定范围中所有形状的填充前景色(假设选定范围中至少有一个形状)。

示例代码
Windows.Item(1).Selection.ShapeRange.Fill.ForeColor.RGB = (255, 0, 255)

使用 Selection.ShapeRange(index) 返回选定范围中的单个形状,其中 index 是形状的名称或索引号。以下示例设置第一个窗口内选定形状的集合中第二个形状的前景填充色(假设该选定范围中至少有两个形状)。

示例代码
Windows.Item(1).Selection.ShapeRange.Item(2).Fill.ForeColor.RGB = (255, 0, 255)


请参阅